• Git
  • what is Git?
  • installing Git on your machine
  • basic commands
  • setting up a Git repo on a local machine
• GitHub
  • what is GitHub?
  • signing up
  • connecting your local Git repo to GitHub
  • selecting an awesome avatar will not be covered

• Think of it as MS Word's "Tracked Changes" on steroids
• Invented by Linus Torvalds (and the Linux development community) in 2005
• Git provides an excellent way to track changes in computer files (e.g., R scripts, LaTeX files, etc.) and coordinating among many users.
• Free book on the Git website: https://git-scm.com/book/en/v2

There are a lot of different ways to use Git, for example, the command line, one of several desktop applications, and even within RStudio.

• I recommend the command line for three reasons: (1) it's simpler (trust me), (2) it's (probably) faster, and (3) it works the same on Windows, Mac, and Linux
• You'll need to know how to open the Terminal in Mac or Command Prompt or Powershell in Windows
• Using it via RStudio is convenient, especially if you're building R packages, etc.
• The desktop application is convenient too, but not available on all operating systems

Installation is rather straightforward: https://git-scm.com/downloads. Just follow the instructions for your particular operating system

Tip: Windows users, you should install from here: https://git-for-windows.github.io/

After Git is successfully installed, open up a terminal and write (with the obvious modifications) the following two lines:

$ git config --global user.name "Brandon Greenwell"
$ git config --global user.email greenwell.brandon@gmail.com

Note: Since you passed the option --global, you only need to do this once!

Note: Technically, you don't need to do this step, but you should!

Note: Windows users should use the Bash terminal that was installed with Git, not the normal Windows command line!

• cd (change directories)
• git init (initialize a folder as a Git repo)
• git add <file-name> (start tracking a new file)
• git commit -m "fix typo" (commit your changes)
• git clone (clone/copy another Git repo [e.g., from GitHub])
• git push origin master (push your master branch to your origin server)
• git pull origin master (update your local repo)

Tip: Typing git add --all will start tracking everything (this is how I almost always use git add).

Make a new folder called arithmetic anywhere on your computer (e.g., the Desktop) that contains a single R script called add.R containing the function

add <- function(x, y) {
  x * y
}

If you want to begin tracking an existing project in Git, you need to start by going to the project's root directory. For example,

cd C:/Users/greenweb/Desktop/arithmetic

takes me to the folder called arithmetic on my Desktop. Then, to initialize this as a Git repo, just type

git init

Tip: the command line has a history (just like the R console), so you don't need to type as often; just hit the up arrow and make any necessary changes!

If you want to start version controlling all the files, you need to start tracking them. In the terminal, type the following:

git add --all

then type:

git commit -m "first commit"

• GitHub is a web-based Git repo and Internet hosting service
• It is the single largest host for Git repos
• Quite popular for code collaboration (no more emails and zip files!!)
• Mostly used for code
• The development versions of a lot of R packages are hosted on GitHub: https://github.com/tidyverse/ggplot2
• All the cool people are using it!

The first thing you need to do is set up an account: https://github.com/

Then go check your e-mail to verify the e-mail address you provided.

Refresh your browswer and see if it worked!

Fix the obvious typo in add.R. Then, take a snapshot (i.e., git add/commit) and push the changes to GitHub (i.e., git push)!

git add --all
git commit -m "fix typo"
git push origin master

Refresh your browser to see the changes.

Tip: It's good practice to do this every time you make a key change (e.g., fix a typo, add a new function to an R script, etc.).

* Make sure you're in the right directory!

Any questions?